countDM (version 0.1.0)

Bell Touchard: PMF, CDF, QF, random generation and parameters estimation based on the Bell Touchard distribution

Description

Evaluates the PMF, CDF, QF, random generation and MLE based on the Bell Touchard distribution. The PMF of the Bell Touchard distribution is as follows: $$ f\left(X=x\mid\lambda,\theta\right)=\exp\left\{ \theta\left[1-e^{\lambda}\right]\right\} \frac{\lambda^{x}\,T_{x}\left(\theta\right)}{x!};\qquad x=0,1,2,\dots, $$ where \(\lambda>0\) and \(\theta>0\) are the two parameters and \(T_{x}\) are the Touchard polynomials, it is given by $$T_{n}=\frac{1}{e}\sum_{k=0}^{\infty}\frac{k^{n}}{k!}.$$ It is important to note that when the parameter \(\theta=1\), the Bell Touchard distribution reduces to Bell distribution.

Usage

dbellt (x, lambda, theta, log = FALSE)
pbellt (q, lambda, theta, lower.tail = TRUE, log.p = FALSE)
qbellt (p, lambda, theta, lower.tail = TRUE, log.p = FALSE)
rbellt (n, lambda, theta)
mle_bt (x, lambda, theta)

Value

dbellt gives the (log) probability function. pbellt gives the (log) distribution function. qbellt gives the quantile function. rbellt generates random values. mle_bt gives the maximum likelihood estimates with standard error of the estimates and model selection measure, the Akaike information criterion (AIC).

Arguments

x

A vector of (non-negative integer) discrete values.

lambda

A vector of (non-negative integer) values, \(\lambda>0\).

theta

A vector of (non-negative integer) values, \(\theta>0\).

q

A probablity or a vector of probablities.

p

A probablity or a vector of probablities.

n

A randomly generated values.

lower.tail

logical; if TRUE (default), probabilities will be P [X <= x], otherwise, P [X> x].

log

logical; if TRUE, probabilities p are given as log(p).

log.p

logical; if TRUE, probabilities p are given as log(p).

Author

Muhammad Imran and M.H. Tahir.

R implementation and documentation: Muhammad Imran and M.H. Tahir <[e-mail]>.

Details

Recently Castellares et al. (2020) proposed a two parameter discrete Bell Touchard distribution that overcomes the issue of over-dispersion (variance larger than mean). Often, we experience the over-dispersed data in practice, where the Poisson model may not be suitable because its variance is restricted to be equal to mean. The PMF of the Bell Touchard distribution is simple and tractible in order to find probablities as well as several properties of the distribution.

References

Castellares, F., Lemonte, A. J., & Moreno–Arenas, G. (2020). On the two-parameter Bell–Touchard discrete distribution. Communications in Statistics-Theory and Methods, 49(19), 4834-4852.

Castellares, F., Ferrari, S. L., & Lemonte, A. J. (2018). On the Bell distribution and its associated regression model for count data. Applied Mathematical Modelling, 56, 172-185.

See Also

mle_borel, mle_poisson, bell_mle

Examples

x<-2
dbellt (x, 2, 2)
pbellt (0.2, 2, 2)
pbellt (0.2, 2, 2)
rbellt (10, 2, 1)
x <- data_sbirth
mle_bt (x, 0.12, 0.2)

# Plot of PMF of the Bell Touchard distribution for selected parameteric values.
# The Bell Touchard distribution reduces to the Bell distribution for fixing theta=1.
x <- 0:50
lambda <- 2
theta <- 1.5

plot(dbellt(x, lambda, theta), type = "h", col="red",lwd = 3,
     main = "Bell Touchard distribution",
     ylab = "P(X = x)", xlab = "Number of events")

legend("topright",c(expression(lambda==2~~theta==1.5)),lty=1, col="red", lwd=2,cex=1.0)